A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
-bash/zsh: pg_dump command not not found # Windows (WSL2) sudo apt-get update sudo apt-get install postgresql-client-9.3 # Debian apt-get install postgresql-client-9.1 # Ubuntu apt-get install postgresql-client-9.3 # Alpine apk add postgresql # Arch Linux pacman -S postgresql-old-upgrade # Kali Linux apt-get install postgresql-client-11 # CentOS yum install postgresql # Fedora dnf install postgresql # OS X brew install postgresql # Raspbian apt-get install postgresql-client-9.5 # Dockerfile dockerfile.run/pg_dump # Docker docker run cmd.cat/pg_dump pg_dump
pg_dump 是一个用于备份 PostgreSQL 数据库的实用程序。即使数据库正在并发使用，它也能进行一致性备份。pg_dump 不会阻止其他用户访问数据库（读取者或写入者）。
pg_dump 只能转储单个数据库。要备份整个集群，或备份集群中所有数据库共有的全局对象（例如角色和表空间），请使用 pg_dumpall。
转储文件可以输出为脚本或归档文件格式。脚本转储是纯文本文件，包含将数据库重建到保存时状态所需的 SQL 命令。要从此类脚本恢复，请将其提供给 psql。脚本文件甚至可以在其他机器和其他架构上重建数据库；只需稍加修改，甚至可以在其他 SQL 数据库产品上重建数据库。
pg_dump [connection-option...] [option...] [dbname]
下面的命令行参数用于控制输出格式。 dbname 声明将要转储的数据库名。 如果没有声明这个参数，那么使用环境变量 PGDATABASE。 如果那个环境变量也没 声明，那么用发起连接的用户名。 -a --data-only 只输出数据，不输出结构（表定义）。 这个选项只是对纯文本格式有意义。对于其它格式，你可以在调用 pg_restore 的时候声明选项。 -b --blobs 在转储中包含大对象。 -c --clean 输出在创建数据库创建命令之前先清理（删除）该数据库对象的命令。 这个选项只是对纯文本格式有意义。对于其它格式，你可以在调用 pg_restore 的时候声明选项。 -C --create 以一条创建该数据库本身并且与这个数据库联接等命令开头进行输出。 （如果是这种形式的脚本，那么你在运 行脚本之前和哪个数据库联接就不重要了。） 这个选项只对纯文本格式有意义。对于其它格式，你可以在调用 pg_restore 的时候声明该选项。 -d --inserts 将数据输出为的 INSERT 命令（而不是 COPY）。 这样会导致恢复非常缓慢。但却令归档更容易移植到其它 SQL 数据库。 -D --column-inserts --attribute-inserts 把数据转储为带有明确字段名的 INSERT 命令。 （INSERT INTO table(column, ...) VALUES ...）。 这样会 导致恢复非常缓慢，但是如果你想重新排列字段的顺序，那么它是必须的。 -f file --file=file 把输出发往指定的文件。如果忽略这些，则使用标准输出。 -F format --format=format 选择输出的格式。 format可以是下列之一： p 输出纯文本SQL脚本文件（缺省） t 输出适合输入到 pg_restore 里的tar归档文件。 使用这个归档允许在恢复数据库时重新排序和/或把 表结构排除在外。 同时也可能可以在恢复的时候限制对哪些数据进行恢复。 c 输出适于给 pg_restore 用的客户化归档。 这是最灵活的格式，它允许对装载的数据和纲要元素进行 重新排列。 这个格式缺省的时候是压缩的。 -i --ignore-version 忽略在 pg_dump 和数据库服务器之间的版本差别。 pg_dump 可以处理来自以前版本的PostgreSQL 的数据库，但是太老的版本则不被支持了（目前是支持到 7.0）。 如果你需要跨越版本检查时才使用这个选项（ 而且如 pg_dump 失效，别说我没警告你）。 -n namespace --schema=schema 只转储 schema 的内容。 如果没有声明这个选项，所有目标数据库中的非系统模式都会被转储出来。 Note: 注意: 在这个模式里，pg_dump 并不试图转储任何其它选定模式可能依赖的数据库对象。 因此，系统不 保证单一的一个模式的转储就可以成功地恢复到一个干净的数据库中去。 -o --oids 为每个表都输出对象标识（OID）。 如果你的应用在某种程度上引用了OID字段的话，（比如，在外键约束中用 到）。 那么使用这个选项。否则，不应该使用这个选项。 -O --no-owner 不把对象的所有权设置为对应源数据库。 By default, pg_dump issues SET SESSION AUTHORIZATION statements to set ownership of created schema elements. These statements will fail when the script is run unless it is started by a superuser (or the same user that owns all of the objects in the script). To make a script that can be restored by any user, but will give that user ownership of all the objects, specify -O. 这个选项只是对纯文本格式有意义。对于其它格式，在你调用 pg_restore 的时候你可以声明该选项。 -R --no-reconnect 这个选项已经过时，但是出于向下兼容的考虑，仍然接受这个选项。 -s --schema-only 只输出表纲要（定义），不输出数据。 -S username --superuser=username 声明关闭触发器时需要用到的超级用户名。 它只有使用了 --disable-triggers 的时候才有关系。 （通 常，我们最好不要输入这个参数，而是用超级用户启动生成的脚本。） -t table --table=table 只输出表 table 的数据。 很可能是在不同模式里面有多个同名表；如果这样，那么所有匹配的表都将被转储 出来。 同时声明 --schema 和 --table 则只选择一个表。 Note: 注意: 在这个模式里，pg_dump 并不试图转储任何其它选定表可能依赖的数据库对象。 因此，系统不保证单 一的一个表的转储就可以成功地恢复到一个干净的数据库中去。 -v --verbose 声明冗余模式。 这样将令 pg_dump 在标准错误上打印进度信息。 -x --no-privileges --no-acl 避免输出 ACL（赋予/撤消 命令）和表的所有者关系信息。 -X use-set-session-authorization --use-set-session-authorization 这个选项废弃了，保留它是为了向下兼容。 pg_dump 现在表现得总是想正式选取了这个选项一样。 -X disable-triggers --disable-triggers 这个选项只是和创建仅有数据的转储相关。它告诉 pg_dump 包含在恢复数据时，临时关闭目标表上面的触发 器的命令。 如果你在表上有参考完整性检查或者其它触发器，而恢复数据的时候你不想重载他们，那么你就应 该使用这个选项。 目前，为 --disable-triggers 发出的命令必须用超级用户来做。 因此，你应该同时用 -S 声明一个超级用户 名，或者最好是用一个超级用户的身份来启动这个生成的脚本。 这个选项只对纯文本格式有意义。对于其它格式，你可以在调用 pg_restore 的时候声明这个选项。 -Z 0..9 --compress=0..9 声明在那些支持压缩的格式中使用的压缩级别。 （目前只有客户化格式支持压缩）。 下面的命令行参数控制数据库为联接参数。 -h host --host=host 声明运行服务器的机器的主机名。 如果数值以斜扛开头，则它被用做到 Unix 域套接字的路径。 缺省是从 PGHOST 环境变量中取得的，如果设置了这个环境变量的话，否则，尝试一个 Unix 域套接字连接。 -p port --port=port 声明服务器正在侦听并等待联接的 TCP 端口或本地 Unix 主控套接字文件句柄。 缺省时使用环境变量 PGPORT 的值（如果存在），或者是编译时的缺省值。 -U username 以给出用户身分联接。 -W 强制口令提示。如果服务器需要口令认证，那么这个动作应该自动发生。
pg_dump 将数据库转储到 SQL 脚本文件中：
pg_dump db_name > output_file.sql
同上，pg_dump 自定义用户名：
pg_dump -U username db_name > output_file.sql
pg_dump 自定义主机和端口：
pg_dump -h host -p port db_name > output_file.sql
pg_dump 将数据库转储到自定义格式的存档文件中：
pg_dump -Fc db_name > output_file.dump
pg_dump 仅将数据库数据转储到 SQL 脚本文件中：
pg_dump -a db_name > path/to/output_file.sql
pg_dump 仅将模式 数据定义 转储到 SQL 脚本文件中：
pg_dump -s db_name > path/to/output_file.sql